home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / script13.arc / SCRIPT.DOC < prev   
Encoding:
Text File  |  1980-01-04  |  8.4 KB  |  199 lines
  1.                                   SCRIPT 1.3
  2.                                       by
  3.                                  Mark Herring
  4.                               February 6th, 1985
  5.  
  6.                       Copyright (c) 1986, by Sparkware.
  7.                          Donated to the Public Domain.
  8.        
  9.        
  10.               
  11.        PURPOSE:
  12.        
  13.        SCRIPT is a BASIC program that will  build  a  PROCOMM  command 
  14.        file that will automatically call up to 10 FIDOs,  log on,  and 
  15.        either upload or download files. 
  16.        
  17.        SCRIPT was written to prevent "GRIDLOCK" of our local FIDOs  in 
  18.        Memphis,  Tennessee.  If  someone  downloaded a few large files 
  19.        from one of our systems,  they could tie the system up for over 
  20.        one  hour  during  the "prime" time,  locking others out of the 
  21.        board. 
  22.        
  23.        With SCRIPT, you can leave your PC running overnight,  and at a 
  24.        designated  time,   PROCOMM  will  handle  the  file  transfers 
  25.        automatically for you.  This not only frees up your  time,  but 
  26.        should make your local sysop that much happier. 
  27.  
  28.  
  29.        REQUIREMENTS:
  30.        
  31.        Any IBM PC or compatible with 256k of RAM, the PROCOMM terminal 
  32.        system, ARC.EXE, LU.EXE, UNSQ.COM and BASICA. 
  33.  
  34.        
  35.              
  36.        HOW TO USE SCRIPT:
  37.        
  38.        Before you may use SCRIPT,  please be sure that you have a copy 
  39.        of ARC.EXE,  LU.EXE and  UNSQ.COM.  These  files  are  used  by 
  40.        SCRIPT  to  unpack  .ARC,  .LBR  and  .LQR  files.  They  don't 
  41.        necessarily have to be located within the PROCOMM subdirectory; 
  42.        just make sure that the PATH has been set to  the  subdirectory 
  43.        within they reside. 
  44.  
  45.        A batch file has been provided to automatically load BASICA and 
  46.        execute SCRIPT.BAS.  Type  "SCRIPT"  at  the  DOS  prompt.  The 
  47.        first  question  asked  will be "CALL directory entry number?". 
  48.        This is the entry number of the  system  to  call  from  within 
  49.        PROCOMM's dialing directory.  If your local FIDO is entry #1 in 
  50.        your  dialing  directory,  you  should  enter a "1".  You'll be 
  51.        prompted to enter another  directory  entry  number  after  you 
  52.        press  the  [RETURN]  key.  Infact,  you  may  call  up  to  10 
  53.        different FIDOs.
  54.        
  55.        Script  will also ask you which type of system you are calling. 
  56.        You may call either  FIDO  version  11q  or  Colossus  systems.  
  57.        Enter a "1" for FIDO or a "2" for Colossus. 
  58.  
  59.        If you press [RETURN] without specifying an entry  number,  and 
  60.        you didn't enter any other FIDO numbers,  you'll be returned to 
  61.        DOS. 
  62.        
  63.        You will run through each FIDO prompts,  one system at a  time.  
  64.        You  can tell which system you are working with by referring to 
  65.        the "BBS:" prompt at the top of your screen: 
  66.  
  67.  
  68. ╔══════════════════════╗     BBS: [Radio Free FIDO]
  69. ║ Procomm Scriptwriter ║     Enter your FIRST name?                            
  70. ║     by Sparkware     ║     Enter your LAST name?                             
  71. ╚══════════════════════╝     Enter your Password?                              
  72.                                                                                
  73.                                                                                
  74. Please enter information below.   To stop, press the [RETURN] key.             
  75.                                                                                
  76. ───────────────────────────────────────────────────────────────────────────────
  77.  ACTION (U/D)    FILE AREA     FILESPEC                 DESCRIPTION            
  78. ───────────────────────────────────────────────────────────────────────────────
  79.        
  80.        
  81.  
  82.        
  83.  
  84.        You should enter your FIRST name and LAST name seperately, just 
  85.        like FIDO would be expecting them.  
  86.  
  87.        Please enter your password after entering your LAST name. 
  88.  
  89.        
  90.        FILESPECS:
  91.        
  92.        The cursor will then jump down to the filespec input area. This 
  93.        is where you'll enter  the  different  filespecs  you  wish  to 
  94.        either  upload  to  or download from each FIDO.  Drivespecs may 
  95.        also be included in  the  filespec  (B:FILENAME.BAS).  You  may 
  96.        upload and download up to 10 different files. 
  97.  
  98.        You'll  notice  that  the  cursor is directly under the "ACTION 
  99.        (U/D)" prompt.  SCRIPT needs to know if you will be [U]ploading 
  100.        or [D]ownloading the filespec you are  about  to  enter.  Press 
  101.        either the [U] key or [D] key. 
  102.  
  103.        If you are finished entering files,  you may press the [RETURN] 
  104.        key here, and you'll proceed to the next FIDO system. 
  105.  
  106.        After answering the ACTION prompt,  you'll need to tell  SCRIPT 
  107.        which  file area this file is located on your FIDO.  If you are 
  108.        uploading a file,  this is the file area to which you  wish  to 
  109.        upload your file. 
  110.  
  111.        Next,  you'll  enter  the filespec you wish to either upload or 
  112.        download. 
  113.        
  114.        Finally, if you are uploading a file,  you should enter a brief 
  115.        description  of  the file underneath the "DESCRIPTION" heading.  
  116.        This description will be sent to FIDO,  to be included  in  the 
  117.        file directory listing. 
  118.  
  119.  
  120.        This  steps  should  be  repeated for each filespec you wish to 
  121.        either upload or download from FIDO. 
  122.  
  123.        
  124.        ERROR CHECKING:
  125.        
  126.        Note:  SCRIPT does not perform ANY error checking.  If you  did 
  127.        not  enter  your  FIRST  name,   LAST  name  or  your  password 
  128.        correctly, you will NOT be logged onto FIDO. 
  129.  
  130.        Likewise,  if you enter the  wrong  file  area,  or  the  wrong 
  131.        filespec,  you  will  NOT be able to download the file.  If you 
  132.        are attempting to upload a file,  and that file is not  in  the 
  133.        current directory, you will NOT be able to upload that file. 
  134.  
  135.  
  136.        SETTING THE TIME:
  137.        
  138.        If you're like me,  you don't bother to set the PC's  clock  to 
  139.        the  current  time.  However,  SCRIPT  requires you to set this 
  140.        clock so it knows when to activate PROCOMM. 
  141.        
  142.        If the time is not set correctly, you will be asked to reset it 
  143.        to the correct time.  Remember to use military time  (ie.  5:00 
  144.        pm = 17:00). 
  145.  
  146.        You should then enter the time you wish PROCOMM to activate.  I 
  147.        usually  like to set the start time 05:00 in the morning.  That 
  148.        way, I don't interfere with the local mail time, and use of the 
  149.        board is very low.  You can set the  timer  for  any  time  you 
  150.        wish, but avoid the local mail slots. 
  151.  
  152.        
  153.        READY AND WAITING:
  154.        
  155.        Finally,  SCRIPT  is  ready to take command of PROCOMM and wait 
  156.        for your start time.  If you need to ABORT  before  your  start 
  157.        time,  you may press the [ESC] key,  and you'll be dropped into 
  158.        DOS. 
  159.  
  160.        
  161.        UNPACKING FILES:
  162.        
  163.        If  you  download  .ARC,  .LBR  or  .LQR  files,   SCRIPT  will 
  164.        automatically  unbundle these files for you after disconnecting 
  165.        from FIDO. 
  166.  
  167.        Here's how SCRIPT does this (with a file named TEST.ARC):
  168.        
  169.        1)  SCRIPT will create a subdirectory named TEST.
  170.        2)  SCRIPT will copy TEST.ARC into subdirectory TEST.
  171.        3)  SCRIPT will delete TEST.ARC from the current directory.
  172.        4)  SCRIPT will change to the TEST subdirectory.
  173.        5)  SCRIPT will then issue a "ARC XW TEST" command.
  174.        6)  SCRIPT will delete TEST.ARC.
  175.        7)  Finally, SCRIPT will return to the parent directory.
  176.        
  177.        If the file you downloaded is an  .LBR  file,  replace  step  5 
  178.        with: 
  179.        
  180.        5)  SCRIPT will then issue an "LU -A TEST" command.
  181.        6)  SCRIPT will delete TEST.LBR.
  182.        
  183.        If  the  file you downloaded is an .LQR file,  these steps will 
  184.        change: 
  185.  
  186.        5a) SCRIPT will then issue an "UNSQ TEST.LQR" command. 
  187.            Please note, you must have UNSQ.COM pathed.  This
  188.            will fail if the file TEST.LQR unsqueezes to anything
  189.            else other than TEST.LBR.
  190.        5b) SCRIPT will then issue a "LU -A TEST.LBR" command.
  191.        6a) SCRIPT will then delete TEST.LQR.
  192.        6b) SCRIPT will then delete TEST.LBR.
  193.  
  194.  
  195.        SUPPORT:
  196.        
  197.        Support for this program is provided thru FIDO 123/5.
  198.  
  199.